# View Configuration

Defines library and list views with columns, sorting, filtering, grouping, and display options.

Referenced by: DocLibCfg.ViewSets, SharepointCfg.ViewCfgs.

# Overview

ViewCfg defines a SharePoint view configuration: which columns are displayed, how items are sorted and grouped, what filters are applied, and how the view behaves.

Nested configurations:

  • NewDocumenTemplate (list) — document creation templates for the view

# Applied when

Views are created when:

  • The parent DocLibCfg is provisioned and references this view via ViewSets
  • Applied during document library provisioning; views are created after the library is created
  • All view properties (columns, sorting, filtering, grouping, display options) are applied when the view is created
  • If DefaultView is true, this view becomes the default view for the library; only one view can be the default

# Core settings

# Name

Type: string | Default: — | Required: Yes

Unique name. Referenced from DocLibCfg.ViewSets.

# Title

Type: string | Default: — | Required: Yes

Display name shown in the view dropdown.

# DefaultView

Type: bool | Default: false | Required: No

Make this the default view when opening the library.

# Columns and display

# Fields

Type: string (list) | Default: see below | Required: No

Default: ["DocIcon", "LinkFilename", "_UIVersionString", "_dlc_DocIdUrl", "Author", "Modified", "Editor", "CheckoutUser"]. Override by providing your own array with internal field names. Example: ["DocIcon", "LinkFilename", "Modified", "Author"].

# Paged

Type: bool? | Default: true | Required: No

Enable pagination (show items per page). When true, items are displayed in pages; when false, all items display on one page.

# RowLimit

Type: uint? | Default: — | Required: No

Only applies when Paged is true. Number of items to display per page. If not specified, uses SharePoint default (typically 30 items).

# IncludeRootFolder

Type: bool? | Default: — | Required: No

Include the root folder in the view. When true, the parent folder appears in the view for navigation.

# Sorting

# OrderBy

Type: string (list) | Default: — | Required: No

Sort expressions. Format: "FieldName ASC" or "FieldName DESC". Example: ["Modified DESC", "Title ASC"].

# Filtering and grouping

# Query

Type: string | Default: — | Required: No

CAML WHERE clause for filtering items. Example: "<Geq><FieldRef Name='Modified'/><Value Type='DateTime'><Today OffsetDays='-30'/></Value></Geq>".

# GroupBy

Type: string (list) | Default: — | Required: No

Field names to group by. Example: ["DocumentType", "Status"].

# View scope and settings

# Scope

Type: enum? | Default: — | Required: No

View scope: Default (current folder only), Recursive (all subfolders), FilesOnly.

# NewDocumenTemplates

Type: NewDocumenTemplate (list) | Default: — | Required: No

Document creation templates available in this view.

# Document templates (within NewDocumenTemplates (list))

# Name

Type: string | Default: — | Required: Yes

Template name (displayed in "New" menu). Example: "Word Document".

# Template

Type: enum | Default: — | Required: Yes

Built-in template type: Word, Excel, PowerPoint, OneNote, Link, Folder.

# ContentType

Type: string? | Default: — | Required: No

Content type to create (alternative to built-in templates).

# Visible

Type: bool | Default: — | Required: Yes

Show in the "New" menu.

Last Updated: 4/20/2026, 12:54:05 PM